“so NOTES 
BY R.A.HILSMANN 


I do not know how many of you 
ever seen the manual that comes 
with the SPECTRUM COMPUTER? It may 
surprise you, how much more this 
manual goes into details. Especial- 
ly about certain Functions which 
are covered in the TIMEX MANUAL 
only in appendices. Lets talk about 
some of the ones not fully covered 
in the TIMEX MANUAL this month. 


DEF FN (defined function) for 
instance, this is what you get out 
of the TIMEX manual: 

User defined function definition; 
must be in a program. Each of a and 
@/i to a/k is either a single 
letter or a single letter followed 
by "S$" for string argument or 
result. 

Takes the form DEF FN a()te if no 
arguments. 


This must be a nightmare to a 
novice to computer's, even to the 
average computer user something not 
gasely understood. Well, lets look 
at what the SPECTRUM MANUAL says 
about Functions in chapter 9 of the 
SPECTRUM MANUAL (edited for this 
column by yours truly). 


FUNCTIONS 


Consider the sausage machine. 
You put a lump of meat in at one 
ənd, turn the handie, and out comes 
Sausage at the other end. A lump of 
pork gives pork sausage, a lump of 
beef gives beef sausage. 

Functions are practically indi- 
stinguishable from sausage machines 
but there is a difference: they 
work on numbers and strings instead 
of meat. You supply one value (cal- 
led the argument), mince it up by 
doing some calculations on it, and 
eventually get another value, the 
result. 

Different arguments give dif- 
ferent results, and if the argument 
is completely inappropriate the 
function will stop and give an 
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error report. 

Just as you can have different 
machines make different products -~ 
one for sausages, another for dish 
cloths, and a third for fish sticks 
and so on, different functions will 
do different calculations. Each 
will have its own value to distin- 
guish it from others. 

You use a function in expres- 
sions by typing its name followed 
by the argument, and when the 
expression is evaluated the result 
of the function will be worked out. 

âs an example there is a 
function called LEN, which works 
out the length of a string. Its 
argument is the string whose length 
you want to find, and its result is 
the length, so that if you type 


PRINT LEN "SINCLAIR" 


the computer will write the answer 
6, the number of the letters in 
"Sinclair". 

If you mix functions and opera- 
tions in a single expression, then 
the functions will be worked out 
before the operations. Again, how- 
ever, you can circumvent this rule 
by using brackets. For instance, 
here are two expressions which dif- 
ter only in the brackets, and yet 
the calculations are performed in 
an entirely different order in each 
case (although, as it happens, the 
results are the same). 


LEN "Bill"+ LEN "Miller" 
4¢+LEnN "Miller" 

4+6 = 10 

LEN ("Bill"+"Miller") 
LEN ("BillMiller'") 

LEN "BiliMiller” 

219 


Here are some more functions. 
STRS converts numbers into strings: 
its argument ig a number, and its 
result is the string that would 
appear on the eeren if the number 
were displayed py -a PRINT state- 
ment. Note how its name ends in a 
$ sign to show that its result is 
a string. 
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For example, you could say 
LET aS=STRS 1e2 
same 


which would have exactly the 
effect as typing 


LET a$="1900" 

or you could say 

PRINT LEN STRS 108.0000 

STRS 


and get the answer 3, because 
100. @02@0="100". 


VAL is like STRS in reverse: it 
converts strings into numbers. For 
instance, 


GO TO VAL "3@8"= GO TO 380 


In this case the result would be a 
Slowdown in your program execution, 
since first the argument is evalu- 
ated as a string, then the string 
quotes stripped off this, and what- 
ever is left is evaluated as a 
number. In a sense, VAL is the 
reverse of STR$S, because if you 
take a number, apply STRS to it, 
and then apply VAL to it, you get 


back the number you first thought 
of. 

However, if you take a string, 
apply VAL to it, and then apply 


STR$ to it, you do not always get 
back to your original string. 

VAL is an extremely power ful 
function, because the string which 
is its argument is not restricted 
to looking like a plain number, it 


can be a numeric expression. Thus, 
for instance, 
VAL "2#3"=6 or even, 
VAL ("2" 4+" 83") 2G 
There are two processes at work 


here. In the first, the argument of 
VAL is evaluated as a string: the 
string expression ee det eR So is 
evaluated to give the string "23", 
Then, the string has its double 
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quotes stripped off, and 
left is evaluated as a number: so 
2*3 is evaluated to give the number 
6. This can be pretty confusing if 
you don’t keep your wits about you; 
for instance, 


PRINT VAL "VAL" "VAL" (LEII a2 oe te bh oe be te 


(Remember that inside a string a 
string quote must be written twice. 
If you go down into further depths 
of strings, then you find that 
quotes need to be quadrupled, or 
even octupled.) 

There is another function, 
rather simular to VAL, although 
probably less useful, called VALS. 
Its argument is still a string, but 
its result is also a string. To see 
how this works, recall how VAL goes 
in two steps: first its argument is 
evaluated as a string, then the 
string quotes stripped off this, 
and whatever is left is evaluated 
as a number. With VALS, the first 
step is the same, but after the 
string quotes have been stripped 
off in the second step, whatever is 


left is evaluated as another 
string. Thus 

VALS "“""Fruit punch""" = "Fruit 
punch" 


(Notice how the string quotes pro- 


liferate again.) Do 


LET a$="99" and print out all of 


the following: VAL a$, VAL "a$", 
VAL """as""". VALS aS, VALS "as" 
and VALS on be "ag" "u LUES 

Some of these will work, and 
some of them wont; try to explain 
all the answers. (Keep a cool 
head. ) 


SGN is the gign function (some- 
times called Signum). It is the 
first function that has nothing to 
do with strings,-because both its 
argument and its result are num- 
bers. The result is +1 if the 
argument is positive. @ if the 
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what is’ 


>“ogument is zero, and -1 if the 
argument is negative. 


: ABS is another function whose 
argument and result are both num- 
bers. It converts the argument into 
a positive number (which is the 
result) by forgetting the sign, so 
that for instance 


ABS -3.2 = ABS 3.2 = 3.2 


INT stands for "integer part". 
An integer is a whole number, pos- 
sibly negative. This function con- 
verts a fractional number into an 
integer by throwing away the frac- 
tional part, so for instance, 


INT 3.9 = 3 


Be carefull when you are apply- 
ing it to negative numbers, because 
it always rounds downs thus, for 
instance, 


INT -3.9 = -4 


SOR calculates the square root 
of a number - the result that, when 
multiplied by itself, gives the 
argument. For instance, 


SOR 4 = 2 because 2#224 
SOR 0.25 = 8.5 because .5*.5=8.25 
SOR 2 = 1.4142136 (approximately) 


because 
1.4142136#1.4142136 = 2.009001 


If you multiply any number (even 
è negative one) by itself, the ans- 
wer is always positive. This means 
that negative numbers do not have 
square roots, so if you apply ‘SOR 
to a negative argument you get an 
error report. 


You can also define functions of 
your own. Possible names for these 
are FN followed by a letter (if the 
result is a number) or FN followed 
by a letter followed by $ (if the 
result is a string). These are much 
stricter about brackets: the argu- 
ment must be enclosed in brackets. 
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You define a function by putting 
a DEF statement somewhere in the 
program. For instance, here is the 
definition of a function FN s whose 
result is the square of the argu- 
ments. ar 


DEF FN s(x) =x#x the square of x) 


After DEF FN, the s completes the 
name FN s of the function. 

The x in brackets is a name by 
which you wish to refer to the arg- 
ument of the function. You can use 
any single letter you like for this 
(or if the argument is a string, a 
single letter followed by $). 

After the = sign comes the actu- 
al definition of the function. This 
can be any exression, and it can 
also refer to the argument using 
the name you've given it (in this 
case, x) as though it were an or- 
dinary variable. 

When you have entered this line, 
you can invoke the function just 
like one of the computer's = own 
functions, by typing its mame, FN 
s, follwed by the argument. Remem- 
ber that when you have defined a 
function yourself, the argument 
must be enclosed in brackets. Try 
this a few times: 


PRINT FN s(2) 
PRINT FN 3 (3+4) 
PRINT 1¢INT FN s (LEN “chicken"/2+3) 


Ones you have put the correspon- 
ding DEF statement in the program, 
you can use your own functions in 
expressions just as freely as you 
can use the computer's. 


Notes in some dialects of BASIC 
you must even enclose the argument 
of one of the computer's functions 
in brackets. This is not the case 
in SINCLAIR BASIC... 


ee 


INT always faunis Gown. To round 
to the nearest .g@nteger, add .5 
first, you could write your own 
function to do this. 


DEF FN r(xd@INT (x+.5) 
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When FN q() 


this would result in x rounded to 


the nearest integer. You will then 
get, for instance, 

FN r(2.9)=3 FN r(2.4)=2 

FN r(-2.9)=-3 FN r(-2.4)=-2 
Compare these with answers you get 


when you use INT instead of FN r. 
Type in and run the following: 


10 LET x=@: LET y=@: LET a=10 
22 DEF FN p(x,y) =atxty 

I0 DEF FN q()®atx#y 

49 PRINT FN p(2,3),FN Q() 


There are a lot of subtle points 


to this program. First a function 
is not restricted to one arguments: 
it can have more, or even none at 


all, but you must still always keep 
the brackets. 

Second, it doesn’t matter where- 
abouts in the program you put the 
DEF statement. After the computer 
has executed line 10, it simply 
skips over lines 20 and 3@ to get 
to line 40. They do, however, have 
to be somewhere in the program. 
They can not be in a direct com- 
mand. 

Third, x and y are 
names of variables in the 
as a whole, and the names of 
ments for the function FN p. 
FN p temporarily forgets about the 
variables called x and y, but since 
it has no argument called a, it 
still remembers the variable a. 
Thus when FN p(2,3) is being eval- 
uated, a has the value 1@ because 
it is the variable, x has the value 
2 because it is the second argu- 
ment. The result is then, 10+2#3=16 
is being evaluated, on 
the other hand, there are no argu- 


both the 
program 
argu- 


ments, SO a,x and y all still refer 
to the variables and have values 
18,0 and Ø respectively. The answer 
in this case is 10+@*@=10. Now 
change line 20 to 
20 DEF FN p(x,y)=FN q() 

This time, FN p(2,3) will have 
the value 10 because FN q will 
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% 
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4 


still go back to the variables x 


and y rather than using the argu- 
ments of FN p. 
Some BASICs (not the SINCLAIR 


BASIC) have functions called LEFT$, 
RIGHTS, MIDS and TLS. 

LEFTS (a$,n) gives the substring 
of a$ consisting of the first n 
characters. 

RIGHTS (a$,n) gives the sub- 
string of a$ consisting of the 
characters from n on. 

MIDS (a@,n1,n2) gives the sub- 


string of a$ consisting of n2 char- 
acters starting at nl. 

TLS (a$) gives the substring of 
a$ consisting of all its characters 


except the first. You can write 
some user defined functions to do 
the same: e.g. 


10 DEF FN t$(a$)=aS(2 TO)=TLS 

20 DEF FN I$(a$,n)=a$(TO n)=LEFTS 
Check that these work with 

strings of length @ or 1. 

Note that our FN I$ has two 
arguments, one a number and the 
other a string. A function can have 
up to 26 numeric arguments and at 
the same time up to 26 string 
arguments. 


Use the function FN s(x)=x*x to 
test SOR: you should find that 


FN s(SOR x)=x if you substitute any 
positive number for x, and 


SOR FN s(x)=ABS' x, 
positive or negative. 


whether x is 


the few 
for an 
all 


Now doesn't this beat 
lines in the TIMEX MANUAL 
explanation of what it is 
about? 


Till next month your #3 (RUDY). 
Pro 
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